home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-13 / vde_mc11.zip / VMC.DOC < prev   
Text File  |  1991-04-02  |  8KB  |  207 lines
  1.  
  2.  
  3.                                     VMC.DOC
  4.                                     -------
  5.                       Instructions for VDE Macro Compiler
  6.                               VMC 1.10 (4/02/90)
  7.           for use with Eric Meyer's VDE editor version 1.53 and above
  8.  
  9.                               VMC.DOC and VMC.COM
  10.                                    Written by
  11.                                   Evan Slawson
  12.  
  13.                         Copyright 1990,1991 Evan Slawson
  14.                               All rights reserved
  15.  
  16.  
  17. ||||||  ABOUT VMC  ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||:
  18.  
  19. VMC, the Macro Compiler for Eric Meyer's VDE editing program, converts
  20. VDE keyboard and function-key macro definition files from their native
  21. format to easy-to-edit text files or vice versa.
  22.  
  23. VMC.DOC covers use of VMC only.  For complete information about VDE's macro
  24. capabilities, please consult VDE documentation.
  25.  
  26. This version of the compiler works only with VDE versions that use the number
  27. 1.53 in their macro file headers.  At this time, this includes VDE versions
  28. 1.53, 1.54, 1.55, 1.6 and 1.61.
  29.  
  30.  
  31. ||||||  WHAT'S NEW  ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
  32.  
  33. VMC v. 1.10 has only one change from previous versions:  It allows
  34. the user to specify that a macro can be Non-repeat, Quiet or Both,
  35. so it is compatible with Eric Meyer's VDE 1.61 release.
  36.  
  37.  
  38. ||||||  USAGE POLICY  ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
  39.  
  40. The VMC utility and its documentation are copyright 1990, 1991 Evan Slawson, all
  41. rights reserved.  They may not be circulated in any incomplete or modified form,
  42. nor sold for profit, without written permission of the author.  VMC.COM and
  43. VMC.DOC must be circulated together.  There is no fee to individuals or
  44. companies for use of VMC.  Any software dealer or library may offer VMC for sale
  45. as long as the price charged for the disk containing VMC does not exceed US
  46. $5.00.  Any other sale of VMC, either alone or together with other software or
  47. hardware, requires a licensing agreement.
  48.  
  49. Address all correspondence to the author:
  50.  
  51. Evan Slawson
  52. 6320 Whitsett Ave. #4
  53. North Hollywood, CA 91606
  54.  
  55. or E-mail at Glendale Litera BBS  818-956-6164
  56.  
  57.  
  58. ||||||  SOURCES  ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||:
  59.  
  60. Please note that copies of VMC   CANNOT   be ordered directly from the author.
  61.  
  62. Glendale Littera QBBS - Glendale, CA  (818)956-6164 is the primary distribution
  63. point for VMC.  If it becomes necessary to update VMC, new versions will be
  64. posted here.
  65.  
  66.  
  67. ||||||  DISCLAIMER  ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
  68.  
  69.                    You undertake to use VMC at your own risk.
  70.             The author assumes no liability for damages of any kind
  71.                         resulting from your use of VMC.
  72.  
  73.  
  74. ||||||  USING VMC  ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||:
  75.  
  76. Place VMC.COM in either the current directory
  77. or a directory that is included in your PATH setting.
  78.  
  79. To use VMC, simply type   VMC <macrodatafilename>
  80.                    or     VMC <macrotextfilename>
  81. from the DOS command line.
  82.  
  83. Macro data files must have these identifiers:
  84.  
  85.    .VDF  for function key macros
  86.    .VDK  for keyboard macros
  87.    (These identifiers are required by VDE as well.)
  88.  
  89. Macro text files must have these identifiers:
  90.  
  91.    .VTF  for function key macros
  92.    .VTK  for keyboard macros
  93.  
  94. An easy way to remember these identifiers is to think of the D in
  95. .VDF and .VDK as "Data" and the T in .VTF and .VTK as "Text".
  96.  
  97. VMC determines the kind of conversion based on the input filename.
  98. The converted output file uses the name portion of the input file
  99. and has the correct identifier for the type of file it is, i.e.:
  100.  
  101.      Input       Output    Conversion
  102.      *.VDK   ->  *.VTK     Keyboard macro data file converted to text file
  103.      *.VTK   ->  *.VDK     Keyboard macro text file converted to data file
  104.      *.VDF   ->  *.VTF     Function key   data file converted to text file
  105.      *.VTF   ->  *.VDF     Function key   text file converted to data file
  106.  
  107. Entering   VMC   without a filename parameter will produce a single-screen
  108. syntax summary for quick reference.
  109.  
  110.  
  111. ||||||  MACRO TEXTFILE FORMAT  ||||||||||||||||||||||||||||||||||||||||||||||||:
  112.  
  113. Macro text files should be plain ASCII files, saved in /A or /N mode of VDE.
  114.  
  115. Macro text files use the same format for both .VTF and .VTK files.
  116.  
  117. Each macro must be typed on a single line.  Each line may contain up to 256
  118. text characters.  VMC aborts if a line compiles to more than 128 characters in
  119. the data file.  This conforms with the VDE limit of 128 characters for any one
  120. macro.  Since control and alt keys may be represented in the text file as
  121. two-character expressions, VMC allows text lines longer than 128 characters.
  122.  
  123. Each macro must begin with a label representing the key it is assigned to.  The
  124. label must be surrounded by [].  The label expression must begin in column 1.
  125.  
  126. For .VTF (function key) files the valid labels are [01]..[48].
  127.  
  128. Remember that VDE assigns function keys like this:
  129.  
  130.          [F1]...[F10]  =  F01...F10 in VDE notation
  131.    Shift-[F1]...[F10]  =  F11...F20
  132.     Ctrl-[F1]...[F10]  =  F21...F30
  133.      Alt-[F1]...[F10]  =  F31...F40
  134.  
  135. If you have an Enhanced (101-key) AT keyboard, also:
  136.           [F11],[F12]  =  F41,F42
  137.     Shift-[F11],[F12]  =  F43,F44
  138.      Ctrl-[F11],[F12]  =  F45,F46
  139.       Alt-[F11],[F12]  =  F47,F48
  140.  
  141. Function keys must be arranged in ascending numeric order in the .VTF file.
  142.  
  143. A .VTF file may have up to 48 lines.
  144.  
  145. Valid .VTK (keyboard macro) labels are in the ranges [0]..[9] and [A]..[Z].
  146. Label letters can be upper or lower case.  Macros must be in the order 0..9,
  147. A..Z in the .VTK file.  .VTK files can have up to 36 lines.
  148.  
  149.  
  150. ||||||  SPECIAL CHARACTERS IN MACRO TEXT FILES  ||||||||||||||||||||||||||||||||
  151.  
  152. There are several special characters in macro text files.
  153.  
  154. The  @  symbol indicates the next key will be an Alt key.  The
  155. next key MUST be in the ranges A-Z or a-z.
  156.  
  157. The  ^  symbol indicates the next key will be a Ctrl key.  The next key
  158. MUST be either ^, [, ], _ or \ or in the ranges A-Z or a-z.  You can also
  159. enter Ctrl keys directly in your text file, by pressing ^P followed by a
  160. letter.  VMC's output file will always convert to the ^ expession.
  161.  
  162. The Escape key can be entered as a control key (^[) or by pressing ^P then
  163. the Escape key.  Again, VMC will always convert to the ^ expression.
  164.  
  165. The  `  (back apostrophe) symbol tells VMC to place the next character in
  166. the data file without any conversion.  This is useful if you need an actual
  167. @ or ^ symbol in your macros.  To enter an actual back apostrophe, you must
  168. place two in a row.
  169.  
  170.  
  171. ||||||  NO REPEAT / QUIET MODES  ||||||||||||||||||||||||||||||||||||||||||||||:
  172.  
  173. To make a macro run in No-repeat mode, Quiet mode or Both, put N, Q or B
  174. as the first character after the label.  (You can also use q or n.)  If
  175. you need a Q, q, N, n, B or B as the actual first letter of a macro, instead
  176. of as a No-repeat, Quiet or Both mode designator, type a ` (back apostrophe)
  177. before it.
  178.  
  179.  
  180. ||||||  ERROR MESSAGES  ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
  181.  
  182. VMC produces error messages for many conditions, including invalid filenames,
  183. invalid macro order, bad macro labels, invalid character following ^ or @ and
  184. some other conditions.  If an error occured in macro processing VMC tells you:
  185.  
  186.   Error occured after macro:
  187.  
  188. and then shows you a macro label.  The label shown indicates the last correctly
  189. processed macro.  Whatever macro follows is where the error occured.
  190.  
  191.  
  192. ||||||  COMMENTING YOUR MACROS  ||||||||||||||||||||||||||||||||||||||||||||||||
  193.  
  194. If you would like to comment your macros, keep the comments in a file named
  195. with the name portion of your macro file and use an extension of .VCK or
  196. .VCF.  Think of the C representing Comments.  Then use VDE and AltW to view
  197. the .VT? and the .VC? files simultaneously.
  198.  
  199.  
  200. ||||||  ACKNOWLEDGEMENTS  ||||||||||||||||||||||||||||||||||||||||||||||||||||||
  201.  
  202. Thanks to Eric Meyer for VMC development suggestions and for VDE in the
  203. first place, and to Fred Haines and Ben Cohen at Glendale Litera BBS for
  204. coming up with the idea of writing a VDE macro compiler.
  205.  
  206.  
  207.